package com.smart.community.work.entity;

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.smart.community.commons.base.BaseEntity;

import lombok.Data;
import lombok.EqualsAndHashCode;

import java.time.LocalDateTime;

/**
 * 访客登记实体类
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Entity规范实现：
 * - 继承BaseEntity：获得标准字段（id、createTime、updateTime、createBy、updateBy、version、deleted）
 * - 功能单一原则：Entity类必须是单纯的数据库字段映射的Bean对象，功能必须单一
 * - 禁止枚举类：所有枚举字段都使用String类型存储，避免使用枚举类
 * - 禁止工具方法：只保留基本的getter/setter方法，禁止添加工具方法
 * - 完整注释：所有字段都有完整的JavaDoc注释
 * - 字段映射：使用@TableField注解正确映射数据库字段
 * 
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Data
@EqualsAndHashCode(callSuper = false)
@TableName("sc_visitor")
public class Visitor extends BaseEntity {
    private static final long serialVersionUID = 1L;

    /**
     * 访客姓名
     */
    @TableField("visitor_name")
    private String visitorName;

    /**
     * 访客电话
     */
    @TableField("visitor_phone")
    private String visitorPhone;

    /**
     * 身份证号
     */
    @TableField("id_card")
    private String idCard;

    /**
     * 访问目的
     */
    @TableField("visit_purpose")
    private String visitPurpose;

    /**
     * 访问对象
     */
    @TableField("visit_target")
    private String visitTarget;

    /**
     * 访问对象电话
     */
    @TableField("visit_target_phone")
    private String visitTargetPhone;

    /**
     * 访问区域
     */
    @TableField("visit_area")
    private String visitArea;

    /**
     * 进入时间
     */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @TableField("entry_time")
    private LocalDateTime entryTime;

    /**
     * 离开时间
     */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @TableField("exit_time")
    private LocalDateTime exitTime;

    /**
     * 登记人ID
     */
    @TableField("registrar_id")
    private Long registrarId;

    /**
     * 访客照片（JSON格式存储文件信息）
     */
    @TableField("visitor_photo")
    private String visitorPhoto;

    /**
     * 状态：1-在访，2-已离开，3-异常
     */
    @TableField("status")
    private Integer status;
}
